Licenciamento ferramentas HTF Apps
O HTF Apps utiliza um sistema de licenciamento baseado em uma chave de instalação vinculada ao ambiente. A licença controla quais módulos e funcionalidades estão disponíveis na instalação.
Obtendo a chave de instalação
A chave de instalação é gerada no Back Office HTF Apps:
- Acesse backoffice.htfapps.com com as credenciais da sua conta.
- Localize ou registre sua instalação.
- Copie a chave de instalação gerada para o seu ambiente.
Configurando no docker-compose.yml
Insira a chave no serviço licensing do docker-compose:
licensing:
environment:
- ADMIN_PASS=admin
- INSTALLATION_CODE=sua_chave_de_instalacao
Reinicie os serviços após inserir a chave.
Módulos licenciáveis
A licença define quais módulos estão ativos na instalação. Os principais módulos são:
| Módulo | Funcionalidade habilitada |
|---|---|
| WFDesigner | Criação e execução de fluxos de trabalho |
| ScanDesigner | Criação e execução de fluxos de captura de documentos |
| IA Gemini | Classificação, divisão e extração de campos via Google Gemini |
| Assinatura | Integrações com plataformas de assinatura eletrônica/digital |
O envio de SMS deixou de exigir licença — passou a usar a conta própria do cliente (veja SMS).
Comportamento sem licença válida
Quando a licença de um módulo está ausente, expirada ou inválida, as funcionalidades correspondentes ficam indisponíveis — mas, em geral, o que já estava em andamento e os dados históricos são preservados. O comportamento por área:
| Módulo / Área | Sem licença válida |
|---|---|
| Ações do Alfresco/Toolkit (PDF, assinatura, validação, metadados, versões) | Somem dos menus do Share e do Content App e são bloqueadas no servidor. |
| 2FA, "Esqueci minha senha" e redefinição de senha | Deixam de ser oferecidos na tela de login (Share e Content App). |
| Relatório de auditoria | Fica indisponível para consulta, mas os eventos continuam sendo gravados — ao renovar a licença, todo o histórico acumulado volta a ficar acessível. |
| IA Gemini | Não aceita novas análises de documento; jobs já enfileirados terminam. |
| Portal de Clientes | A abertura de novos chamados é bloqueada (exige licença do WFDesigner/Portal); a consulta aos chamados existentes continua disponível. |
Workflows e capturas já em execução seguem processando mesmo que a licença seja desativada no meio — o bloqueio vale para novas operações.
Verificando o status da licença
O serviço licensing valida continuamente a chave de instalação. Se a licença expirar ou a chave for inválida:
- Funcionalidades licenciadas deixam de estar disponíveis.
- Tentativas de uso retornam a mensagem
"nolicense"nos logs e no comportamento do sistema.
Consulte os logs do container licensing para diagnóstico:
docker logs licensing
A chave de instalação é vinculada ao ambiente e não pode ser compartilhada entre instalações diferentes. Para ambientes de desenvolvimento e produção, solicite chaves separadas no Back Office.